home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / datatypes / targa.datatype / targa.datatype.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  9KB  |  162 lines
  1. @DATABASE "targa.datatype.guide"
  2. @$VER: targa.datatype.guide 39.0 (22.1.95)
  3. @AUTHOR "Arthur Pijpers"
  4. @NODE Main "targa.datatype Documentation"
  5. @{B}Table of Contents@{UB}
  6. @{" Introduction                           " link Introduction}
  7. @{" Requirements                           " link Requirements}
  8. @{" How to Install                         " link Installation}
  9. @{" What is a Targa file ?                 " link Targa }
  10. @{" What is a datatype?                    " link Datatypes}
  11. @{" Implementation Details (Release Notes) " link Implementation}
  12. @{" Revision history                       " link History}
  13. @{" Acknowledgements                       " link Acknowledgements}
  14. @{" Author                                 " link Author}
  15. @ENDNODE
  16. @NODE Introduction
  17. @{B}Introduction@{UB}
  18. This is V39.0 of the @{"targa" link targa} @{"datatype" link Datatypes}. The version information can be verified
  19. by using the AmigaDOS @{B}version@{UB} command on the datatype file
  20. SYS:classes/datatypes/targa.datatype after installation.
  21. Once installed, the targa datatype means that any datatype-aware programs can
  22. read @{"Targa" link Targa} image files.
  23. Examples of this are that a Targa image can be used as a Workbench screen
  24. backdrop, and Multiview can be used to display them.
  25. The targa datatype is freely distributable, but you may not charge for it,
  26. other than for reasonable media and distribution costs such as those charged
  27. by Fred Fish and other reputable PD libraries.
  28. The targa datatype can be distributed as part of a datatype collection, but
  29. then you have to supply both the 68000 and the 68020 version.
  30. @ENDNODE
  31. @NODE Requirements
  32. @{B}Requirements@{UB}
  33. Datatypes were introduced with Workbench 3.0, so the main requirement is
  34. that you have this version of the OS. Presumably, any future versions of the
  35. OS will also support them.
  36. Do not try to install the datatype if you are using an OS older than 3.0
  37. (i.e. 1.3, 2.04, or 2.1).  The correct directories do not exist, and nothing
  38. will work even if you create them.  I'm afraid you'll have to find some
  39. other program to view your @{"Targa" link Targa} files with.
  40. When you use the datatype on a computer without the AGA chipset, then 
  41. pictures with more than 16 colours hires or 32 colours lores are
  42. automatically dithered to the maximum number of available colours, unless
  43. you have a graphical card added.
  44. 24 and 32 bit pictures need AGA chips (or AGA-emulation) to be displayed
  45. correctly.
  46. @ENDNODE
  47. @NODE Installation
  48. @{B}How to Install@{UB}
  49. Installation can be done in one of two ways:
  50. 1) Using Installer
  51. 2) Manual Installation
  52. If you have a copy of Installer, you can simply double click on the
  53. targa.datatype.install icon and follow the onscreen instructions. The
  54. Installer script follows the manual sequence below, so you are advised to
  55. read it quickly so that you know what to expect.
  56. If you do not have Installer, (which is strange, because you have
  57. Workbench 3), then follow the procedure below:
  58. 1) Copy the file targa.datatype.68000 or targa.datatype.68020 to the directory
  59. SYS:classes/datatypes and rename it to targa.datatype (SYS: is a logical name
  60. for the disk you boot from).  You can perform the copy either from the
  61. Workbench or the Shell. Use the 68020 version only on Amigas with a 68020
  62. processor or higher.
  63. 2) Decide whether you want the datatype to be permanently enabled, or
  64. manually run whenever you want to use it.  Proceed to step 3 for a
  65. permanently enabled installation, otherwise proceed to step 4.
  66. 3) Copy the file "Targa" to the directory DEVS:Datatypes (DEVS: is a
  67. logical directory on the disk you boot from.  It is the same as the DEVS
  68. drawer on the boot disk).  If using the Shell, you will also have to
  69. manually copy the icon file "Targa.info".  When you reboot your system,
  70. the targa datatype will be avaliable for use.
  71. 4) Copy the file "Targa" to the directory SYS:Storage/Datatypes. If
  72. using the Shell, you will also have to manually copy the icon file
  73. "Targa.info".
  74. The targa datatype will not be available until you double click on the
  75. "Targa" icon, at which point it will remain installed until a reboot.
  76. If you already had an older version of the targa.datatype, then you can remove
  77. the files Targa and Targa.info from the DEVS:DataTypes directory.
  78. This completes installation.
  79. @ENDNODE
  80. @NODE Targa
  81. @{B}What is a Targa file ?@{UB}
  82. A Targa file is a graphical file format. It is most of the time used to store
  83. 24 bit pictures, but there are also formats for 1 to 8, 15, 16 and 32 bits.
  84. Targa files don't have special characters in the header to recognize it.
  85. Therefor a Targa file can only be recognized by the extension of the filename.
  86. This extension must be .tga or .TGA, or the file will not be recognized.
  87. TARGA and TGA are registered trademarks of Truevision, Inc.
  88. @ENDNODE
  89. @NODE Datatypes
  90. @{B}What is a Datatype?@{UB}
  91. Datatypes were introduced with Workbench 3.0, and provide a way for
  92. applications to read data files without having to learn all the messy
  93. details about how the data in the files are stored.
  94. As an example, consider storing pictures on computer.  As Amiga owners, we
  95. are relatively lucky in that all images are stored using the IFF ILBM
  96. format.  Other computers have a bewildering array of incompatible formats,
  97. and there exist commercial packages with the sole purpose of converting
  98. images between them.
  99. If I wanted to write a paint program, it would certainly be more useful if
  100. it could read and maybe write out images in some of these other formats.
  101. However, implementing such feature would be a bit of a nightmare, as I would
  102. have to obtain the specifications of these formats, plus some test images,
  103. and write (and support) a significant amount of code to read and write these
  104. various formats.
  105. A datatype is a little program that performs this conversion for me, and
  106. completely hides all the messy implementation details about what file
  107. headers exist, how they are structured, etc.  My application can open the
  108. datatypes library, pass a file to it and ask if it recognises the format.
  109. The datatypes library has a look at the file, and then consults its list of
  110. installed datatypes to see if any of them recognise it.  It then comes back
  111. to the application with a reply saying "Yup, its a Targa picture".
  112. My application can then ask for the data to be read in, and after a short
  113. while the library will return the information in an Amiga standard format,
  114. in this case, an IFF image.  Of course, someone has to write the datatype,
  115. but once written and installed, any other program that uses datatypes can
  116. take advantage of it at no extra cost or expense.
  117. This datatype decodes Targa images, and any application that wishes to read
  118. this format of images can do so without having to know anything about them.
  119. @ENDNODE
  120. @NODE Implementation
  121. @{B}Implementation Details (Release Notes)@{UB}
  122. These are the release notes for V39.0 of the targa datatype.
  123. This implementation will decode @{"Targa" link Targa} files in up to 256 colours.
  124. 24 and 32 bit Targa images are converted to HAM8. For 32 bit images, the alpha
  125. channel data are skipped.
  126. 15 and 16 bit images have not been implemented yet, because I don't have
  127. complete documentation about the storage format. If anyone can Email me some
  128. more information of the Targa format, then I can try to implement that too.
  129. If you are using Multiview to display @{"Targa" link Targa} files without
  130. the SCREEN tooltype/parameter, the @{"Targa" link Targa} file will be
  131. displayed in a window on the Workbench, it will be quantised down to however
  132. many colours you have set up on your Workbench screen. 24 and 32 bit pictures
  133. however are always shown on a separate HAM8 screen.
  134. If you are using Multiview with the SCREEN tooltype/parameter, the datatype
  135. will choose the screen resolution that it thinks is most appropriate for
  136. displaying the image from the selection available in the display database.
  137. This decision is made using the BestModeID function, and is based on the
  138. size, colour count and aspect ratio of the image.
  139. @ENDNODE
  140. @NODE History
  141. @{B}Revision History@{UB}
  142. Version 39.0 released 22-1-1995
  143.  - First release
  144. @ENDNODE
  145. @NODE Acknowledgements
  146. @{B}Acknowledgements@{UB}
  147. targa datatype is based on the BMP datatype.
  148. Many thanks to John Hendrikx (Textdemo/FastView) for the Chunky2Planar and
  149. RGBtoHAM8 routines
  150. targa datatype was compiled using SAS/C V6.51
  151. TARGA and TGA are registered trademarks of Truevision, Inc.
  152. @ENDNODE
  153. @NODE Author
  154. @{B}Author@{UB}
  155. Arthur Pijpers
  156. Please feel free to contact me at:
  157. Usenet  : arthurp@grafix.xs4all.nl
  158. FidoNet :  2:286/407.37
  159. AMYNet  : 39:153/201.37
  160. NLANet  : 14:101/200.37
  161. @ENDNODE
  162.